home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / archiver / zoo21src.zoo / readme.st < prev    next >
Text File  |  1991-07-23  |  5KB  |  113 lines
  1.     This files describes the implementation of the Atari ST version of Zoo 2.1.
  2. Please read ZOO.MAN and then read this file.
  3.  
  4. GENERAL
  5. -------
  6. ST Zoo 2.1 is completely backward compatible with the port of Zoo 2.01 I did.
  7. In 2.01 we had optimized the compression and decompression functions for speed.
  8. In 2.1 we did not optimize the old-style compression/decompression functions in
  9. lieu of the more efficient "high compression" functions.  Therefore, 2.1 may
  10. not be as fast as 2.01 in extracting old format archives.  I stress that 2.1 is
  11. 100% backwards compatible with 2.01, just not as fast when dealing with old
  12. format archives.  We will be concentrating on optimizing the speed of the new
  13. compression/decompression functions in future versions.
  14.  
  15. ST Zoo requires 400K+ available free memory when using the high compression
  16. option.  Very tight on a 512K machine.
  17.  
  18. ST Zoo accepts both slashes and backslashes as directory separators.
  19.  
  20. ST Zoo preserves the attributes of archived files.  So if you archive a
  21. Read-Only file, it will be extracted as a Read-Only file.  PLEASE NOTE:  Not
  22. all attributes of an Atari file are preserved, as these are not transportable
  23. across systems.  ex. the archive bit.
  24.  
  25. ST Zoo doesn't allow Zoo to be used as a filter. 
  26.  
  27. NEW OPTIONS
  28. -----------
  29. // - This option will recursively decend all the directories in the specified
  30.      path when used in conjunction with the 'a' command.  NOTE: This is Atari
  31.      specific and will change if/when R. Dhesi adds this option internally to
  32.      Zoo.  This does not affect the ability of Zoo on other platforms to
  33.      extract these archives.
  34.  
  35. NOVICE COMMANDS
  36. ---------------
  37. -add
  38. -freshen
  39. -update
  40. -move    - All default to the high compression mode.
  41.  
  42. -backup  - This is the same as the expert command 'ah//'.  It will recursively
  43.            descend all directories in the path during an add.
  44.  
  45. -restore - This is the same as the expert command 'x//'.  It will extract files
  46.            from the archive using full pathnames, if present.
  47.  
  48. WILDCARD HANDLING FROM THE DESKTOP
  49. ----------------------------------
  50. The wildcard expansion routines used in the ST version of Zoo understand the
  51. following elements:
  52.     * or *.*    - Any sequence of zero or more characters.
  53.     ?           - Any single character.
  54.     [x...y]     - Any single character specified by the set x...y, where any
  55.                   character other than minus sign or close bracket may appear
  56.                   in the set.  A minus sign may be used to indicate a range of
  57.                   characters.  ex. [0-5abc] is shorthand for [012345abc].  More
  58.                   than one range may appear inside a character set.  ex.
  59.                   [0-9a-zA-Z._] matches almost all of the legal characters for
  60.                   a host name.
  61.     [^ x...y]   - Any character NOT in the set, which is interpreted as 
  62.                   described above.
  63.     \*, \?, \[  - A *, ? or [ character.  ex. If you named a file '*' and you
  64.                   want it added to a Zoo archive, you would use the following
  65.                   command line:  'zoo ah foo.zoo \*'.  Try to avoid doing this.
  66. See wildmat.man and README.WM for more details.
  67.  
  68. UNIXMODE
  69. --------
  70. The released binary of Zoo does not fully support UNIXMODE.  The only
  71. option of UNIXMODE not supported is mixed case.  This can be changed by
  72. undefining FOLD in options.h and recompiling Zoo.  See the TOS section of
  73. options.h for more details.  Undefining FOLD will NOT cause any compatibility
  74. problems with produced archives.  If you are unable to recompile Zoo and
  75. want the UNIXMODE version, contact me at one of the email addresses below.
  76.  
  77. ZOOPAUSE
  78. --------
  79. If you launch ST Zoo from the desktop, it will wait for a keypress when it is
  80. done with it's current operation.  If ST Zoo is launched from a recognized CLI
  81. (currently Gulam, Master 5.0 & 5.4, Craft) or if the environment variable SHELL
  82. is set, ST Zoo will NOT wait for a keypress.  You may also set the environment
  83. variable ZOOPAUSE to either "yes" or "no", depending on whether you want ST Zoo
  84. to wait or not.
  85.  
  86. ACKNOWLEDGMENTS
  87. ---------------
  88.  
  89. This port of Zoo was done using GCC V1.40 and the excellent libraries 
  90. distributed with it.  Thanks to Jwahar Bammi and Eric Smith for all of the 
  91. time and labor they put into this compiler package.
  92.  
  93. Thanks to Jwahar Bammi for all the time/code/ideas he donated to this project.
  94.  
  95. Thanks to Rahul Dhesi for developing Zoo and making it freely available to 
  96. all users, on all platforms.
  97.  
  98. Thanks to Rich Salz for releasing his wildmat code to the public.  It saved us
  99. alot of headaches developing our own from scratch.
  100.  
  101. Thanks to Dan Jitta for his port of Zoo 2.01 to the ST.  We used several of his
  102. ideas in this port.
  103.  
  104.  
  105. Please send all comments, suggestions, and bug reports to:
  106.  
  107. Bill Shroka
  108. bjsjr@NCoast.ORG
  109. ncoast!bjsjr@usenet.ins.cwru.edu
  110. uunet!usenet.ins.cwru.edu!ncoast!bjsjr
  111. GEnie: B.SHROKA
  112.  
  113.